BGCOLOUR_QL
BGCOLOUR_24
BGIMAGE

Syntax: BGCOLOUR_QL [#ch,] colour
     or BGCOLOUR_QL [#ch,] colour1,colour2 [,pattern]

    and BGCOLOUR_24 [#ch,] colour
     or BGCOLOUR_24 [#ch,] colour1,colour2 [,pattern]

    and BGIMAGE [#ch,] filename

Location: SMSQ/E v2.98+

It is possible under the latest version of SMSQ/E to set a 'wallpaper' - this is an image which covers the whole of the available screen (in any resolution) and which forms a background for any programs which may be running.  Normally, this would appear as a black area of the screen.

These commands allow you to set up the wallpaper.

A valid window channel must be open, default #1 (or #0 on a SBASIC with only #0 open), although one may also be supplied as #ch.

BGCOLOUR_QL allows you to specify any standard QL colour as the wallpaper - the parameters allowed are the same as for the INK command (in either Standard QL Colour Mode or COLOUR_QL mode).

BGCOLOUR_24 allows you to specify any 24 Bit Colour - the parameters allowed are the same as for the INK command (in COLOUR_24 mode), which thus allows for you to specify composite colours.

BGIMAGE allows you to load a screen image as a wallpaper to cover the whole of the available screen (in any resolution).

The file will need to be a screen snapshot - the Photon JPEG viewer can be used to convert JPEG files to screen snapshots.

Examples:
BGCOLOUR_24 $920000,$ff0092,3 - sets a checkerboard pattern of Dark Red and Shocking Pink.

BGIMAGE win1_wallpapers_cats - load a wallpaper.

CROSS-REFERENCE:
See INK for colour details
SBYTES gives details on how to store a screen on disk.
In many ways, BGIMAGE is similar to LOADPIC, except that it caters for non-standard QL resolutions and colour depths.
